home *** CD-ROM | disk | FTP | other *** search
/ System Booster / System Booster.iso / Archives / ForCLI / lsort13.lha / LSort / LSort.doc < prev    next >
Text File  |  1995-12-11  |  3KB  |  95 lines
  1.  
  2. *****************************************************************************
  3.  
  4.                     LSort 1.3 (10.12.95) © Konrad Dubiel
  5.  
  6. *****************************************************************************
  7.  
  8.  
  9.                                 INTRODUCTION
  10.                                --------------
  11.  
  12.     LSort is a freeware and may be freely distributed as long as all files
  13. remain unchanged. The author can not be taken responsible for any damage
  14. caused by this program or its improper use.
  15.  
  16.     LSort is a localized Sort command, it uses standard locale.library's
  17. functions for string comparison. It adapts automatically to sorting rules
  18. of preferred language set in Locale preferences. LSort supports all options
  19. of original Sort, so it can be used as replacement command.
  20. LSort requires Workbench 2.1 or later.
  21.  
  22.  
  23.                                IMPORTANT NOTE
  24.                               ----------------
  25.  
  26.     Original Commodore's locale.library and some #?.language files contain
  27. bugs in character comparison table which results in improper sorting of some
  28. languages. These bugs do not only apply to LSort, but to programs like David
  29. Ekholm's db also. To fix this problem I've included in this archive corrected
  30. language files which should be copied to 'LOCALE:Languages' directory:
  31.  
  32. deutsch.language  - letter ß is placed after S.
  33. norsk.language    - letters Æ, Ø and Å are placed after Z.
  34. svenska.language  - letters Å, Ä and Ö are placed after Z.
  35. íslenska.language - written from scratch.
  36.  
  37. If any other language is still sorted incorrectly please let me know.
  38.  
  39.  
  40.                                     USAGE
  41.                                    -------
  42.  
  43. LSort have to be run from Shell only and can be made resident using
  44. 'Resident LSort' command.
  45.  
  46. Template:
  47.     LSort FROM/A,TO/A,COLSTART/K/N,CASE/S,NUMERIC/S,REVERSE/S,NOBLANKS/S
  48.  
  49. FROM       - input file name (to be sorted) - may be PIPE:.
  50. TO         - output file name (after sorting) - may be the same as input.
  51. COLSTART   - starting column number.
  52. CASE       - case sensitive sorting - upper case letters first.
  53. NUMERIC    - numeric sorting - lower number first.
  54. REVERSE    - reverse sorting direction (Z-A or higher numbers first).
  55. NOBLANKS   - skip leading blank characters (spaces, tabs).
  56.  
  57. Examples:
  58.  
  59. LSort FROM file1 TO file2
  60. This command will sort file1 and write result to file2
  61.  
  62. LSort file file COLSTART 10
  63. Sort starting from 10th column and save to the same file
  64.  
  65. LSort file CONSOLE: COLSTART 5 NUMERIC
  66. Numeric sorting starting from 5th column, output to Shell window.
  67.  
  68. LSort file1 file2 REVERSE NOBLANKS
  69. Reverse sorting with leading spaces being skipped from comparison
  70.  
  71. LSort PIPE: PRT: CASE
  72. Read file from PIPE:, case sensitive sorting and output to printer.
  73.  
  74.  
  75.                                    HISTORY
  76.                                   ---------
  77.  
  78. 1.0 - Initial release.
  79. 1.1 - norsk.language added (thanks to Øyvind Falch).
  80. 1.2 - New options: CASE and NUMERIC, deutsch.language and svenska.language
  81.       (thanks to Albin Gierun) added.
  82. 1.3 - íslenska.language added (thanks to Arni Freyr Jonsson).
  83.  
  84.  
  85.                                    AUTHOR
  86.                                   --------
  87.  
  88. Suggestions and bug-reports please send to:
  89.  
  90. Konrad Dubiel
  91. ul. Bartnicza 12/5
  92. 71-487 Szczecin
  93. Poland
  94. E-mail: konrad@felix.univ.szczecin.pl
  95.